home *** CD-ROM | disk | FTP | other *** search
/ ftp.whtech.com / ftp.whtech.com.7z / ftp.whtech.com / emulators / mess / MESS 0.133 / Macintosh / MessMenu 0.7.0 OSX uni.dmg / docs / windows.txt < prev    next >
Encoding:
Text File  |  2009-06-19  |  15.2 KB  |  363 lines
  1. This file describes Windows-specific usage information about MAME. It is
  2. intended to cover aspects of using and configuring the program that are
  3. specific to running MAME from the command line on a Windows-based system.
  4. For common options that apply to all systems, please see config.txt.
  5.  
  6.  
  7.  
  8. Default Keys
  9. ------------
  10.  
  11. In addition to the keys described in config.txt, the following additional
  12. keys are defined for Windows versions of MAME:
  13.  
  14.  
  15. Alt+Enter Toggles between full-screen and windowed mode.
  16.  
  17.  
  18.  
  19. Windows debugging options
  20. -------------------------
  21.  
  22. -[no]oslog
  23.  
  24.     Outputs the error.log data to the Windows debugger. This can be used at
  25.     the same time as -log to output the log data to both targets as well.
  26.     Default is OFF (-nooslog).
  27.  
  28.  
  29.  
  30. Windows performance options
  31. ---------------------------
  32.  
  33. -priority <priority>
  34.  
  35.     Sets the thread priority for the MAME threads. By default the priority
  36.     is left alone to guarantee proper cooperation with other applications.
  37.     The valid range is -15 to 1, with 1 being the highest priority. The
  38.     default is 0 (NORMAL priority).
  39.  
  40. -[no]multithreading / -[no]mt
  41.  
  42.     Enables multithreading within MAME. At the moment, this causes the
  43.     window and all DirectDraw/Direct3D code to execute on a second thread,
  44.     which can improve performance on hyperthreaded and multicore systems.
  45.     The default is OFF (-nomultithreading).
  46.  
  47.  
  48.  
  49. Windows video options
  50. ---------------------
  51.  
  52. -video <gdi|ddraw|d3d|none>
  53.  
  54.     Specifies which video subsystem to use for drawing. By specifying 'gdi'
  55.     here, you tell MAME to render video using standard Windows graphics
  56.     drawing calls. This is the slowest but most compatible option.
  57.     Specifying 'ddraw' instructs MAME to use DirectDraw for rendering.
  58.     This causes MAME to render everything at a lower resolution and then
  59.     upscale the results at the end. This produces high performance,
  60.     especially on older or low-power video cards, but has a noticeably
  61.     lower output quality. Specifying 'd3d' tells MAME to use Direct3D for
  62.     rendering. This produces the highest quality output and enables all
  63.     rendering options. It is recommended if you have a recent (2002+)
  64.     video card. The final option 'none' displays no windows and does no
  65.     drawing. This is primarily present for doing CPU benchmarks without
  66.     the overhead of the video system. The default is d3d.
  67.  
  68. -numscreens <count>
  69.  
  70.     Tells MAME how many output windows to create. For most games, a single
  71.     output window is all you need, but some games originally used multiple
  72.     screens. Each screen (up to 4) has its own independent settings for
  73.     physical monitor, aspect ratio, resolution, and view, which can be
  74.     set using the options below. The default is 1.
  75.  
  76. -[no]window
  77.  
  78.     Run MAME in either a window or full screen. The default is OFF
  79.     (-nowindow).
  80.  
  81. -[no]maximize / -[no]max
  82.  
  83.     Controls initial window size in windowed mode. If it is set on, the
  84.     window will initially be set to the maximum supported size when you
  85.     start MAME. If it is turned off, the window will start out at the
  86.     smallest supported size. This option only has an effect when the
  87.     -window option is used. The default is ON (-maximize).
  88.  
  89. -[no]keepaspect / -[no]ka
  90.  
  91.     Enables aspect ratio enforcement. When this option is on, the game's
  92.     proper aspect ratio (generally 4:3 or 3:4) is enforced, so you get the
  93.     game looking like it should. When running in a window with this option
  94.     on, you can only resize the window to the proper aspect ratio, unless
  95.     you are holding down the CONTROL key. By turning the option off, the
  96.     aspect ratio is allowed to float. In full screen mode, this means that
  97.     all games will stretch to the full screen size (even vertical games).
  98.     In window mode, it means that you can freely resize the window without
  99.     any constraints. The default is ON (-keepaspect).
  100.  
  101. -prescale <amount>
  102.  
  103.     Controls the size of the screen images when they are passed off to the
  104.     graphics system for scaling. At the minimum setting of 1, the screen
  105.     is rendered at its original resolution before being scaled. At higher
  106.     settings, the screen is expanded by a factor of <amount> before being
  107.     scaled. With -video ddraw or -video d3d, this produces a less blurry
  108.     image at the expense of some speed. In -video ddraw mode, this also
  109.     increases the effective resolution of non-screen elements such as
  110.     artwork and fonts. The default is 1.
  111.  
  112. -effect <filename>
  113.  
  114.     Specifies a single PNG file that is used as an overlay over any game
  115.     screens in the video display. This PNG file is assumed to live in the
  116.     root of one of the artpath directories. The pattern in the PNG file is
  117.     repeated both horizontally and vertically to cover the entire game
  118.     screen areas (but not any external artwork), and is rendered at
  119.     the target resolution of the game image. For -video gdi and -video d3d
  120.     modes, this means that one pixel in the PNG will map to one pixel on
  121.     your output display. For -video ddraw, this means that one pixel in the
  122.     PNG will map to one pixel in the prescaled game screen. If you wish to
  123.     use an effect that requires mapping n PNG pixels to each game screen
  124.     pixel with -video ddraw, you need to specify a -prescale factor of n as
  125.     well. The RGB values of each pixel in the PNG are multiplied against the
  126.     RGB values of the target screen. The default is 'none', meaning no
  127.     effect.
  128.  
  129. -[no]waitvsync
  130.  
  131.     Waits for the refresh period on your computer's monitor to finish
  132.     before starting to draw video to your screen. If this option is off,
  133.     MAME will just draw to the screen at any old time, even in the middle
  134.     of a refresh cycle. This can cause "tearing" artifacts, where the top
  135.     portion of the screen is out of sync with the bottom portion. Tearing
  136.     is not noticeable on all games, and some people hate it more than
  137.     others. However, if you turn this option on, you will waste more of
  138.     your CPU cycles waiting for the proper time to draw, so you will see a
  139.     performance hit. You should only need to turn this on in windowed mode.
  140.     In full screen mode, it is only needed if -triplebuffer does not
  141.     remove the tearing, in which case you should use -notriplebuffer
  142.     -waitvsync. Note that this option does not work with -video gdi mode.
  143.     The default is OFF (-nowaitvsync).
  144.  
  145. -[no]syncrefresh
  146.  
  147.     Enables speed throttling only to the refresh of your monitor. This
  148.     means that the game's actual refresh rate is ignored; however, the
  149.     sound code still attempts to keep up with the game's original refresh
  150.     rate, so you may encounter sound problems. This option is intended
  151.     mainly for those who have tweaked their video card's settings to
  152.     provide carefully matched refresh rate options. Note that this option
  153.     does not work with -video gdi mode.The default is OFF (-nosyncrefresh).
  154.  
  155.  
  156.  
  157. DirectDraw-specific options
  158. ---------------------------
  159.  
  160. -[no]hwstretch / -[no]hws
  161.  
  162.     When enabled, MAME uses the hardware stretching abilities of your
  163.     video card to scale the game image and associated artwork to the
  164.     target resolution. Depending on the quality of your graphic card and
  165.     its drivers, this may be a fractional, antialiased scaling (nice) or
  166.     an integer, blocky scaling (not so nice), in which case you might want
  167.     to disable this option. In addition, if you have configured specific
  168.     arcade-like video modes for MAME and don't want MAME to perform any
  169.     non-integral scaling of the image, you should also disable this option.
  170.     The default is ON (-hwstretch).
  171.  
  172.  
  173.  
  174. Direct3D-specific options
  175. -------------------------
  176.  
  177. -d3dversion <version>
  178.  
  179.     MAME supports both Direct3D 9 and Direct3D 8 for maximum compatibility.
  180.     By default, it will automatically detect which one it can use and use
  181.     that version exclusively. You can override MAME's selection with this
  182.     option. It is primarily intended as a means for the MAME developers to
  183.     test compatibility with older hardware; for the most part, there is no
  184.     reason to alter this setting. The default is 9.
  185.  
  186. -[no]filter / -[no]d3dfilter / -[no]flt
  187.  
  188.     Enable bilinear filtering on the game screen graphics. When disabled,
  189.     point filtering is applied, which is crisper but leads to scaling
  190.     artifacts. If you don't like the filtered look, you are probably better
  191.     off increasing the -prescale value rather than turning off filtering
  192.     altogether. The default is ON (-filter).
  193.  
  194.  
  195.  
  196. Per-window options
  197. ------------------
  198.  
  199. -screen <display>
  200. -screen0 <display>
  201. -screen1 <display>
  202. -screen2 <display>
  203. -screen3 <display>
  204.  
  205.     Specifies which physical monitor on your system you wish to have each
  206.     window use by default. In order to use multiple windows, you must have
  207.     increased the value of the -numscreens option. The name of each
  208.     display in your system can be determined by running MAME with the
  209.     -verbose option. The display names are typically in the format of:
  210.     \\.\DISPLAYn, where 'n' is a number from 1 to the number of connected
  211.     monitors. The default value for these options is 'auto', which means
  212.     that the first window is placed on the first display, the second
  213.     window on the second display, etc.
  214.  
  215.     The -screen0, -screen1, -screen2, -screen3 parameters apply to the
  216.     specific window. The -screen parameter applies to all windows. The
  217.     window-specific options override values from the all window option.
  218.  
  219. -aspect <width:height> / -screen_aspect <num:den>
  220. -aspect0 <width:height>
  221. -aspect1 <width:height>
  222. -aspect2 <width:height>
  223. -aspect3 <width:height>
  224.  
  225.     Specifies the physical aspect ratio of the physical monitor for each
  226.     window. In order to use multiple windows, you must have increased the
  227.     value of the -numscreens option. The physical aspect ratio can be
  228.     determined by measuring the width and height of the visible screen
  229.     image and specifying them separated by a colon. The default value for
  230.     these options is 'auto', which means that MAME assumes the aspect
  231.     ratio is proportional to the number of pixels in the desktop video
  232.     mode for each monitor.
  233.  
  234.     The -aspect0, -aspect1, -aspect2, -aspect3 parameters apply to the
  235.     specific window. The -aspect parameter applies to all windows. The
  236.     window-specific options override values from the all window option.
  237.  
  238. -resolution <widthxheight[@refresh]> / -r <widthxheight[@refresh]>
  239. -resolution0 <widthxheight[@refresh]> / -r0 <widthxheight[@refresh]>
  240. -resolution1 <widthxheight[@refresh]> / -r1 <widthxheight[@refresh]>
  241. -resolution2 <widthxheight[@refresh]> / -r2 <widthxheight[@refresh]>
  242. -resolution3 <widthxheight[@refresh]> / -r3 <widthxheight[@refresh]>
  243.  
  244.     Specifies an exact resolution to run in. In full screen mode, MAME
  245.     will try to use the specific resolution you request. The width and
  246.     height are required; the refresh rate is optional. If omitted or
  247.     set to 0, MAME will determine the mode auomatically. For example,
  248.     -resolution 640x480 will force 640x480 resolution, but MAME is free to
  249.     choose the refresh rate. Similarly, -resolution 0x0@60 will force a
  250.     60Hz refresh rate, but allows MAME to choose the resolution. The
  251.     string "auto" is also supported, and is equivalent to 0x0@0. In window
  252.     mode, this resolution is used as a maximum size for the window. This
  253.     option requires the -switchres option as well in order to actually
  254.     enable resolution switching with -video ddraw or -video d3d. The
  255.     default value for these options is 'auto'.
  256.  
  257.     The -resolution0, -resolution1, -resolution2, -resolution3 parameters
  258.     apply to the specific window. The -resolution parameter applies to all
  259.     windows. The window-specific options override values from the all
  260.     window option.
  261.  
  262. -view <viewname>
  263. -view0 <viewname>
  264. -view1 <viewname>
  265. -view2 <viewname>
  266. -view3 <viewname>
  267.  
  268.     Specifies the initial view setting for each window. The <viewname>
  269.     does not need to be a perfect match; rather, it will select the first
  270.     view whose name matches all the characters specified by <viewname>.
  271.     For example, -view native will match the "Native (15:14)" view even
  272.     though it is not a perfect match. The value 'auto' is also supported,
  273.     and requests that MAME perform a default selection. The default value
  274.     for these options is 'auto'.
  275.  
  276.     The -view0, -view1, -view2, -view3 parameters apply to the
  277.     specific window. The -view parameter applies to all windows. The
  278.     window-specific options override values from the all window option.
  279.  
  280.  
  281.  
  282. Full screen options
  283. -------------------
  284.  
  285. -[no]triplebuffer / -[no]tb
  286.  
  287.     Enables or disables "triple buffering". Normally, MAME just draws
  288.     directly to the screen, without any fancy buffering. But with this
  289.     option enabled, MAME creates three buffers to draw to, and cycles
  290.     between them in order. It attempts to keep things flowing such that one
  291.     buffer is currently displayed, the second buffer is waiting to be
  292.     displayed, and the third buffer is being drawn to. -triplebuffer will
  293.     override -waitvsync, if the buffer is sucessfully created. This option
  294.     does not work with -video gdi. The default is OFF (-notriplebuffer).
  295.  
  296. -[no]switchres
  297.  
  298.     Enables resolution switching. This option is required for the
  299.     -resolution* options to switch resolutions in full screen mode. On
  300.     modern video cards, there is little reason to switch resolutions unless
  301.     you are trying to achieve the "exact" pixel resolutions of the original
  302.     games, which requires significant tweaking. This option is also useful
  303.     on LCD displays, since they run with a fixed resolution and switching
  304.     resolutions on them is just silly. This option does not work with
  305.     -video gdi. The default is OFF (-noswitchres).
  306.  
  307. -full_screen_brightness / -fsb <value>
  308.  
  309.     Controls the brightness, or black level, of the entire display. The
  310.     standard value is 1.0. Selecting lower values (down to 0.1) will produce
  311.     a darkened display, while selecting higher values (up to 2.0) will
  312.     give a brighter display. Note that not all video cards have hardware to
  313.     support this option. This option does not work with -video gdi. The
  314.     default is 1.0.
  315.  
  316. -full_screen_contrast / -fsc <value>
  317.  
  318.     Controls the contrast, or white level, of the entire display. The
  319.     standard value is 1.0. Selecting lower values (down to 0.1) will produce
  320.     a dimmer display, while selecting higher values (up to 2.0) will
  321.     give a more saturated display. Note that not all video cards have
  322.     hardware to support this option. This option does not work with
  323.     -video gdi. The    default is 1.0.
  324.  
  325. -full_screen_gamma / -fsg <value>
  326.  
  327.     Controls the gamma, which produces a potentially nonlinear black to
  328.     white ramp, for the entire display. The standard value is 1.0, which
  329.     gives a linear ramp from black to white. Selecting lower values (down
  330.     to 0.1) will increase the nonlinearity toward black, while selecting
  331.     higher values (up to 3.0) will push the nonlinearity toward white. Note
  332.     that not all video cards have hardware to support this option. This
  333.     option does not work with -video gdi. The default is 1.0.
  334.  
  335.  
  336.  
  337. Windows sound options
  338. ---------------------
  339.  
  340. -audio_latency <value>
  341.  
  342.     This controls the amount of latency built into the audio streaming. By
  343.     default MAME tries to keep the DirectSound audio buffer between 1/5 and
  344.     2/5 full. On some systems, this is pushing it too close to the edge,
  345.     and you get poor sound sometimes. The latency parameter controls the
  346.     lower threshold. The default is 1 (meaning lower=1/5 and upper=2/5).
  347.     Set it to 2 (-audio_latency 2) to keep the sound buffer between 2/5 and
  348.     3/5 full. If you crank it up to 4, you can definitely notice the lag.
  349.  
  350.  
  351.  
  352. Input device options
  353. --------------------
  354.  
  355. -[no]dual_lightgun / -[no]dual
  356.  
  357.     Controls whether or not MAME attempts to track two lightguns connected
  358.     at the same time. This option requires -lightgun. This option is a hack
  359.     for supporting older dual lightgun setups. If you have multiple
  360.     lightguns connected, you will probably just need to enable -mouse and
  361.     configure each lightgun independently. The default is OFF
  362.     (-nodual_lightgun).
  363.